                       PIXSTR v.1.00
                       =============
                Programmed by Raider Croft
             La Serena, Chile. November 2002.
               raider_croft_01@hotmail.com                     

            Tomb Raider Libraries by Turbo Pascal.
                   Tegucigalpa, Honduras.   
                   cyber_pascal@yahoo.es
___________________________________________________________________

ENGLISH:
========

INDEX
1.- What is PixStr?.
2.- Differences between PixStr and StrPix.
3.- Working with PixStr.
4.- Using DXF.
5.- Official site for PixStr distribution.
6.- Comments, Ideas...
7.- Thanks.

1.- WHAT IS PIXSTR?
==================
It is a software who lets you open any TR file (from TR1 to TR5) and edit things like:
-Models Textures
-Models (with a CAD program)
-Static Meshes Light.
-and More.

This software, with just a little of imagination, can create very good models for your levels, for example personalized objects, Retextured Items, and a Good outfit for Lara.

2.- DIFFERENCES BETWEEN PIXSTR AND STRPIX
=========================================
a) The Name :-)
b) PixStr opens COMPILED levels (tr1,tub,tr2,tr4,trc) and StrPix just can open Wads for tr4.
c) PixStr is just starting (v.1.00) and StrPix goes in v.3.00 (as i remember)
d) PixStr was created IDEALLY for the UNOFFICIAL Level Editor users, but StrPix was created thinking just in the TRLE users.

3.- WORKING WITH PIXSTR
=======================
*Selecting an Item:
You can choose:
-Movable (Group of Meshes)
-Static Mesh
-Mesh (As part of a Movable)

*RED polygons:
These are the "Colored Polygons", and i recommend you to use the "Convert Colored to Textured" option (Meshes menu) when you are going to export to DXF format.

*Working With Textures:
-Select a texture piece of the panel.
-Click on the face where you want to apply the Texture.

You can change the properties of the Current Texture:
-Opaque, Transparent or Semi-Transparent attrib.
-Flip Horizontal/Vertical
-Export/Import current texture to BMP.

*Selecting a Mode for work:
-Wireframe, Solid or textured.

*Working with Static Meshes Boxes:
-You can Enable/Disable the "Show Box" option.
-You must select: Visibility or Colisional  to work with Boxes.
-You can change the Height, Width and Depth of the Static Mesh, or use the "Automatic Bound" Button.

*Working with Static Meshes Lights:
-You can Enable/Disable the Lights Mode.
-Select intensity: 0 maxium brigtness 31 maxium darkness.
-You can select wich vertex will be affected when you apply the light.
-Click on the Face of the model (Static Mesh) to apply the Light.

*Working with Menus
===================
-Edit: CTRL+U for Undo and CTRL+R for Redo. JUST ONE LEVEL for Undo/Redo.

-Textures:
   Export/Import BMP: Export/Import the group of textures of the complete level to a BMP file.
   
   Export/Import Current to BMP: The same idea, but with the current texture.

-Meshes:
   Convert Colored to textured: Change all the colored polygons for the current texture. I RECOMMEND YOU ALLWAYS use this option before export to DXF.

   Retexture Mesh: Apply the current texture to the complete Mesh/Static Mesh.
   
   Apply Intensity Alpha: Apply the SemiTransparent Attrib to all textures of the current Mesh/Static Mesh, BUT remember: Sometimes textures were applied to two or more items in the level.

-View:
   You can select the BackGround color: White or Black.
   
   Enable/Disable the Perspective Correct. ATTENTION: Maybe PixStr can run slowly if this option es enabled.

-About, Language: Select here the Language (Shift+f2 for edit)

4.- USING DXF
=============
You can select a Mesh/Static Mesh and then:
-EXPORT TO DXF: The mesh selected is saved in DXF format, then you can edit it with your favorite CAD program.

-IMPORT DXF: You can import a DXF, and this model will REPLACE the selected Mesh.

IMPORTANT:
-Colored Polygons are showed in Red. When you export to DXF, the colored polygons ARE NOT considered. When you import a DXF, the polygons in color are losed.

-The DXF type COMPATIBLE with PixStr is that who uses 3DFACES entities,  where Triangles are defined using 4 vertex, duplicateing the third vertex.

-When a DXF is imported over a Static Mesh, then the model is imported with a light intensity value of "0".

-When a DXF is imported over a MESH (a part of a movable) then the model is imported with calculated light reflection values.

-Dimensions of the models in DXF are in a scale of 1/100, i mean, a model with the dimensions 10.24 x 10.24 are the width and height of a TR sector.

-The generated DXF by PixStr includes a layer for each group of differents textures used in the moel, the name of each layer is in the way: "TEXTURE_XXXX" where "XXXX" is the number of the Texture and filled with "0" to the left for getting always a size of four digits, for example: TEXTURE_0008, TEXTURE_0040, TEXTURE_0120 etc.

-Models drawed in a CAD program MUST have polygons drawed on the ClockWise direction, and only the frontal part is rendered.

-Maybe exists a LIMIT in the amount of Vertex or polygons per model, On this moments, they are unknownn. If yor level crashes then the limit of vertex/polygons is overloaded.

5.- OFFICIAL SITE FOR PIXSTR DISTRIBUTION
=====================================
For Spanish Speaking People:
-LARA CROFT REGRESA (http://come.to/TR6)

For English Speaking People:
-THE VAGRANT'S WORLD (http://home.acadia.net/userpages/vagrant/)

6.- COMMENTS, IDEAS...
======================
Any comment, idea, Bugs Report, etc.. are received in my email: raider_croft_01@hotmail.com or in my Web Site LARA CROFT RETURNS (http://come.to/TR6)

7.- THANKS
==========
Since i saw StrPix as a tool for the TRLE, i wanted it for tr1->tr5 (for the Unnoficial level editor users), but it was never created... Until now.

THANKS TO TURBO PASCAL for his libraries. He shared his work with me before the libraries were available on his web site. Thanks for teaching me a lot of TR things, because with your help i am releasing this PixStr program.

THANKS to everybody who has wanted this tool long time ago, and to people who is happy with its creation.

And finally THANKS to PixStr users. I know they will give me ideas, comments for the upcomming versions.

Raider Croft.
Noviembre 2002
___________________________________________________________________

ESPAOL:
========

CONTENIDO:
1.- Qu es el PixStr?.
2.- Diferencias entre PixStr y StrPix.
3.- Trabajando con PixStr.
4.- Usando el DXF.
5.- Sitio oficial para su distribucin.
6.- Comentarios, Ideas...
7.- Agradecimientos.

1.- QUE ES EL PIXSTR?
======================
Es un Software que te permite abrir cualquier nivel Tomb Raider (Desde TR1 hasta TR5) y editar entre algunas cosas:
-Texturas de los modelos.
-Forma de los modelos.
-Luces de los Static Meshes.
-Ms.

Este programa, con un poco de imaginacin, puede crear algunos buenos modelos para tus niveles, por ejemplo objetos personalizados, Items retexturizados, y algn buen Traje para Lara.

2.- DIFERENCIAS ENTRE PIXSTR Y STRPIX
=====================================
a) El nombre :-)
b) PixStr abre niveles ya COMPILADOS (tr1,tub,tr2,tr4,trc) y el StrPix abre tan solo los Wads (limitndose a editar unicamente niveles TR4)
c) PixStr recin est empezando (v.1.00) y StrPix va en (v.3)
d) PixStr fue creado IDEAlMENTE para los usuarios del editor NO OFICIAL. El StrPix en cambio, fue creado 100% para los usuarios del TRLE.

3.- TRABAJANDO CON PIXSTR
=========================
*Seleccionando un Item:
Puedes seleccionar tres tipos de Items:
-Movable (conjunto de meshes)
-Static Mesh (mesh esttico)
-Mesh (Mesh, parte de un movable)

*Polgonos marcados en ROJO:
Estos se denominan polgonos de color, y es preferible usar la opcin "Convertir de color a Texturizado" en el men Meshes.

*Trabajando con Texturas:
-Selecciona alguna de las texturas del panel.
-Haz click en el "face" que deseas aplicar la textura.

Puedes cambiar las propiedades de la textura actual:
-Opaca, Transparente, Semitransparente
-Girar Horizontalmente/Verticalmente
-Exportar/Importar la textura actual a un BMP.

*Seleccionando un modo de Visualizacin:
-Alambre, Slido o Texturizado.

*Trabajando con las Cajas de los Static Meshes:
-Puedes habilitar/deshabiliar la opcion "Show Box" (mostrar caja)
-Debes seleccionar el tipo de "Box" (caja): Visibilidad o Colision
-Puedes editar el largo, ancho, y profundidad del Static Mesh, o bien, ajustarlos con el botn "Automatic Bound" (lmite automtico)

*Trabajando con las Luces de los Static Meshes:
-Puedes habilitar/Deshabilitar el Modo de luces.
-Seleccionar una intensidad: 0 maximo brillo, 31 maxima oscuridad.
-Puedes seleccionar qu vertices sern afectados al aplicar la luz.
-haz click en el "face" del modelo (Static Mesh) para aplicar la luz.

*Trabajando con los Mens:

-Men "Edit" (Edicion): CTRL+U para deshacer, CTRL+R  para Rehacer. SOLO se permite 1 nivel de Undo/Redo

-Men "Textures" (Texturas):
   Export/Import BMP: Exporta/importa el conjunto de texturas del nivel a un BMP.
   
   Export/Import Current BMP: Lo mismo, pero con la textura actual.

-Men Meshes:
   Opcion "Convertir poligono de color a texturizado": Cambia todos los "faces"  de color del Mesh seleccionado, y les aplica la textura actual. Opcion recomendada al exportar a DXF.
   
   Retexturizar Mesh: Aplica la misma textura a todo el Mesh/ Static Mesh.

   Aplicar "Intensity Alpha": Aplica el atributo SEMITRANSPARENTE a todas las texturas del mesh seleccionado, pero CUIDADO: Recuerda que hay texturas que se repiten en otros Meshes del nivel.

-Men "View" (Ver):
   Puedes seleccionar el color de fondo: Blanco o Negro.
   
   Habilitar/Deshabilitar la correccin de perspectiva. Atencin: Tenerla habilitada, puede hacer que se trabaje en forma mas lenta.

-Men "Acerca De, Lenguaje": Aqu se selecciona el lenguaje (Lenguaje original del programa: Ingles. Viene con la traduccion al Espaol.)

4.- USANDO EL DXF
=================

Puedes seleccionar un Mesh/Static Mesh y luego:
-EXPORTARLO: El Mesh seleccionado es guardado en formato DXF, para luego poder ser editado con tu programa de modelamiento 3D favorito.

-IMPORTAR: Puedes importar un DXF, y ste reemplazar al Mesh que tenas seleccionado.

NOTAS:
- Los polygonos en color son mostrados en color Rojo, al exportar un archivo DXF los polygonos con color no son considerados. Al Importar un modelo DXF los polygonos en color se pierden.

- EL Tipo de DXF compatible con pixstr es aquel en el que se usa entidades 3DFACES y en que los triangulos se definen especificando 4 vertices duplicando el tercero.

- Cuando se importa un modelo DXF sobre un mesh utilizado por un static mesh entonces el modelo es importado con un valor de intensidad de luz de "0".

- Cuando se importa un modelo DXF sobre un mesh utilizado por un movable entonces el modelo es importado con valores calculados de reflexion de luz.

- Las dimensiones de los de los modelos en los DXF es en scala de 1/100 es decir que un modelo con las dimensiones 10.24 x 10.24 son el ancho y largo de un sector en el Tomb Raider.

- El DXF generado por Pixstr incluye un "layer" por cada grupo de texturas diferentes usadas en el modelo, el nombre de cada layer es de la forma: "TEXTURE_XXXX" donde "XXXX" es el numero de la textura y rellenado con "0" a la izquierda para obtener siempre un tamao fijo de 4 digitos, por ejemplo: TEXTURE_0008, TEXTURE_0040, TEXTURE_0120 etc.

- Los modelos dibujados en un programa CAD deven tener los polygonos dibujados en direccion "clockwise", y solamente la parte frontal es renderizada.

- Posiblemente exista limite de cantidad de vertices o de polygonos por modelo, Por el momento se deconocen. Si tu nivel cae cuando lo intentas jugar, es probablemente porque ests usando ms alla del lmite de vertices.
  
5.- SITIO OFICIAL PARA LA DISTRIBUCION DEL PIXSTR
=================================================
Para la gente habla hispana:
-LARA CROFT REGRESA (http://come.to/TR6) 

Para la gente habla inglesa:
-THE VAGRANT'S WORLD (http://home.acadia.net/userpages/vagrant/)

6.- COMENTARIOS IDEAS
=====================
Cualquier comentario, idea, sugerencia, Reporte de Errores, puedes hacerlo a travs de mi e-mail raider_croft_01@hotmail.com o bien a travs de mi sitio web LARA CROFT REGRESA (http://come.to/TR6)

7.- AGRADECIMIENTOS
===================
Desde que vi el StrPix como una herramienta para el TRLE, quise una parecida, pero para los usuarios del TREDITOR3D.
Por causas desconocidas, sta no se pudo crear... Hasta Ahora.

GRACIAS A TURBO PASCAL por las librerias que ha compartido conmigo (antes de ponerlas gratis en su sitio) y por ensearme algunas cosas para poder terminar con esta version del PixStr.

GRACIAS a quienes han querido esta herramienta desde hace mucho tiempo, y a los que se muestran contentos por su creacin.

y finalmente GRACIAS a los que van a ser usuarios del PixStr y que seguramente van a dar ideas para las futuras versiones de esta herramienta.

Raider Croft
Noviembre 2002